Skip to content

Spark as starter theme, legacy identifiers callout, Theme Kit links, disputes and campaign notes, reference redirect - #49

Merged
next-devin merged 2 commits into
mainfrom
agent-entry-p4
Sep 3, 2026
Merged

Spark as starter theme, legacy identifiers callout, Theme Kit links, disputes and campaign notes, reference redirect#49
next-devin merged 2 commits into
mainfrom
agent-entry-p4

Conversation

@next-devin

Copy link
Copy Markdown
Contributor

Follow-up to #48. The wording that waited on the product owner, plus three small things two clean-agent evaluation runs on 2026-09-03 tripped over.

What

  • Spark is the starter theme. Getting Started and the Theme Kit guide point at NextCommerceCo/spark; Intro Bootstrap is named as the older Bootstrap-based alternative in the Theme Kit warning.
  • Legacy identifiers, in plain words. A "Why 29next?" callout under the Admin API path: Next Commerce was formerly 29 Next; store and account hostnames, the X-29next-API-Version and X-29Next-Signature headers, and the API key namespace still carry that name; current on every store, not scheduled to change. Same sentence in /llms.txt and AGENTS.md. One evaluation run found the rename only in llms.txt and a second missed it entirely because its fetch tool summarised the file.
  • Themes overview links its own Theme Kit page instead of sending readers to GitHub. An evaluation run followed the GitHub pointer, guessed /docs/themes/theme-kit, got a 404, and reported the CLI commands as undocumented.
  • Webhooks: a callout that dispute.* covers chargebacks and pre-chargeback alerts; nothing said "chargeback" before. Campaigns: one sentence that campaign orders are regular store orders.
  • AGENTS.md corrections line: no public correction route yet; use your support contact.
  • Redirect /docs/admin-api/reference to /docs/admin-api in both public/_redirects and netlify.toml. The old Redoc-style URL is linked nine times from the platform changelog and was a 404.

Verified

  • npm run build, npm run check-agent-surfaces pass. validate-links still reports only the pre-existing h4-fragment error in the fulfillment-service guide.

Decision needed from — none; the starter theme and REST wording were Alex's answers, the support route stays open by his call.

Sibling PR: NextCommerceCo/docs#33.

🤖 Generated with Claude Code

…disputes and campaign-order notes, reference redirect

- Getting Started and Theme Kit guide: Spark is the starter theme; Intro
  Bootstrap named as the older Bootstrap-based alternative.
- Admin API overview: 'Why 29next?' callout: former name; hostnames,
  headers, API key namespace carry it; current, not scheduled to change.
  Same wording in llms.txt and AGENTS.md.
- Themes overview: links its own Theme Kit page instead of GitHub (a
  clean-agent run guessed a wrong URL and concluded the commands were
  off-site).
- Webhooks: dispute events cover chargebacks and alerts. Campaigns:
  campaign orders are regular store orders.
- AGENTS.md corrections: no public route yet, use your support contact.
- Redirect /docs/admin-api/reference -> /docs/admin-api (old Redoc URL
  still linked nine times from the platform changelog, was a 404).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 3, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
developer-docs 7e3b0c7 Commit Preview URL

Branch Preview URL
Sep 03 2026, 09:22 AM

@next-devin
next-devin marked this pull request as ready for review September 3, 2026 09:10
Comment thread content/docs/storefront/themes/index.mdx Outdated
Comment thread content/docs/storefront/themes/index.mdx
Comment thread content/docs/webhooks/index.mdx
Comment thread netlify.toml Outdated
Comment thread public/_redirects
@kilo-code-bot

kilo-code-bot Bot commented Sep 3, 2026

Copy link
Copy Markdown

Code Review Summary

Status: No Issues Found | Recommendation: Merge

All 5 issues from the previous review are addressed in 7e3b0c7:

  • content/docs/storefront/themes/index.mdx:9 — Link text updated to "Read the Theme Kit guide".
  • content/docs/storefront/themes/index.mdx:144 — Trailing newline added.
  • content/docs/webhooks/index.mdx:81 — Body reworded; title and body now describe the same behavior without making claims about future events.
  • netlify.toml:361 — Comment confirms exact-path semantics, with verified behavior on preview.
  • public/_redirects:79-82 — Comment added and trailing-slash form listed (Cloudflare needs both forms listed).

No new issues found on the incremental diff.

Files Reviewed (4 changed files)
  • content/docs/storefront/themes/index.mdx - 0 issues
  • content/docs/webhooks/index.mdx - 0 issues
  • netlify.toml - 0 issues
  • public/_redirects - 0 issues
Previous Review Summary (commit eef8008)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit eef8008)

Status: 5 Issues Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 4
Issue Details (click to expand)

WARNING

File Line Issue
content/docs/storefront/themes/index.mdx 144 Missing trailing newline at end of file

SUGGESTION

File Line Issue
content/docs/storefront/themes/index.mdx 9 Link text "Install Theme Kit" doesn't match the broader destination guide
content/docs/webhooks/index.mdx 81 Callout title and body make slightly different claims about chargeback events
netlify.toml 361 Verify Netlify from semantics so the new redirect doesn't shadow deep reference paths
public/_redirects 79 Add a short comment so future edits don't accidentally wildcard the exact-path redirect
Files Reviewed (10 files)
  • AGENTS.md - 0 issues
  • app/llms.txt/route.ts - 0 issues
  • content/docs/admin-api/index.mdx - 0 issues (text additions consistent with sibling sites)
  • content/docs/campaigns/index.mdx - 0 issues
  • content/docs/index.mdx - 0 issues
  • content/docs/storefront/themes/index.mdx - 2 issues
  • content/docs/storefront/themes/theme-kit.mdx - 0 issues
  • content/docs/webhooks/index.mdx - 1 issue
  • netlify.toml - 1 issue
  • public/_redirects - 1 issue

Fix these issues in Kilo Cloud


Reviewed by minimax-m3 · Input: 29K · Output: 2.3K · Cached: 197.7K

…ute callout wording, redirect comments and trailing-slash form

The changelog links the old reference URL with a trailing slash and a
query string; Cloudflare exact-path rules do not cover that variant, so
both forms are listed. Deep reference pages verified unaffected on the
branch preview.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@next-devin
next-devin merged commit 7672b98 into main Sep 3, 2026
2 checks passed
@next-devin
next-devin deleted the agent-entry-p4 branch September 3, 2026 12:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant